SHIELD Gate 로그 정의서

개요

본 문서는 SHIELD Gate의 로그 구조를 정의하여 Splunk 등 외부 로그 분석 시스템에서 로그를 수집하고 분석할 수 있도록 가이드합니다.

※ 최종 업데이트 : 25-11-14

로그 샘플

다음은 모든 주요 필드에 값이 포함된 단일 로그 샘플입니다.

{
  "traceId": "SHIELDGate-aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
  "time": 1763012869412,
  "ip": "10.10.10.0",
  "userId": "user@example.com",
  "logLevel": "INFO",
  "logType": "ADMIN",
  "action": "ALLOW",
  "brandName": "SHIELDGate",
  "serviceName": "SHIELDGate",
  "tenantId": "AAAA-BBBB-CCCC-DDDD-EEEE",
  "target": "https://example.com/file.pdf",
  "event": "FILE_DOWNLOAD",
  "description": "File download completed",
  "detail": "{\"from\":{\"name\":\"정책명1\"},\"to\":{\"name\":\"정책명2\"}}",
  "user": {
    "id": "user@example.com",
    "name": "홍길동",
    "depart": "개발팀/백엔드팀"
  },
  "corp": {
    "id": "AAAA-BBBB-CCCC-DDDD-EEEE",
    "name": "EXAMPLE COMPANY"
  },
  "file": {
    "name": "example.pdf",
    "ext": "pdf",
    "path": "/documents/example.pdf",
    "storageName": "SharePoint Storage"
  },
  "policy": {
    "id": "policy-xxxxx",
    "name": "파일 다운로드 정책",
    "type": "STORAGE",
    "rule": "{\"access\":\"allow\",\"conditions\":{}}"
  },
  "workSystem": {
    "id": "pppppppp-qqqq-rrrr-ssss-tttttttttttt",
    "type": "app",
    "name": "그룹웨어 시스템",
    "desc": "회사 내부 문서 및 일정 관리 시스템",
    "url": "https://groupware.company.co.kr/main",
    "prevUrl": "https://portal.company.co.kr",
    "isIap": false,
    "domain": "groupware.company.co.kr",
    "category": "business",
    "isAllow": true
  },
  "sensitive": {
    "isAllow": true,
    "inputData": "user input data",
    "regexes": "\\d{3}-\\d{4}-\\d{4}"
  },
  "err": {
    "type": "NETWORK_ERROR",
    "desc": "서버와의 통신 중 문제가 발생하였습니다."
  },
  "rbi": {
    "url": "https://rbi.example.com/12345"
  }
}

공통 필드

모든 로그에 공통적으로 포함되는 기본 필드입니다.

필드명	타입	설명	입력값 예시
`traceId`	string	서비스 간 흐름을 추적하기 위한 ID	`SHIELDGate-aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee`
`time`	timestamp	로그 생성 시간 (millisecond, epoch_millis)	`1763012869412`
`ip`	string	로그 생성 IP 주소	`10.42.13.0`
`userId`	string	이벤트 행위자의 사용자 ID	`user@example.com`
`logLevel`	string	로그 레벨 (에러가 발생한 이벤트는 logLevel : ERROR)	`ERROR`, `WARN`, `INFO`, `DEBUG`, `TRACE`
`logType`	string	로그 타입 분류 (관리자 로그/사용자 로그)	관리자 로그 : `ADMIN` 사용자 로그 : `USER`
`action`	string	사용자 행위의 차단 여부를 분류하는 필드	`DENY`: 정책이나 보안 규칙에 의해 행위가 차단됨 (예: URL 접근 차단, 파일 실행 차단) `ALLOW`: 정책이나 보안 규칙에 의해 행위가 허용됨 (예: URL 접근 허용, 파일 실행 허용) `빈 값("")`: 조건부 정책과 무관한 이벤트
`brandName`	string	이벤트가 발생한 서비스 이름	SHIELD Gate : `SHIELDGate` Security365 관리센터 : `Security365 Portal`
`tenantId`	string	인증인가에 등록된 고객사 ID	`AAAA-BBBB-CCCC-DDDD-EEEE`
`target`	string	이벤트의 대상이 되는 파일명, 사용자, URL 등 연관 정보	`https://example.com/file.pdf`, `example.pdf`
`event`	string	이벤트 코드 문자열 (허용문자: 대문자, _)	SHIELD Gate 이벤트 코드 목록 참조
`description`	string	이벤트 상세 설명 (표현용 문자열)	`File download completed`
`detail`	string	정책이나 설정 변경 시 변경 전후 값을 저장하는 필드 (JSON 문자열 형태) `from`: 변경 전 값 `to`: 변경 후 값	`{"from":{"name":"정책명1"},"to":{"name":"정책명2"}}`

사용자 객체 (user)

로그 이벤트의 행위자 정보를 담는 객체입니다.

필드명	타입	설명	입력값 예시
`user.id`	string	사용자 아이디	`user@example.com`
`user.name`	string	사용자 이름	`홍길동`
`user.depart`	string	사용자 부서	`개발팀/백엔드팀`

고객사 객체 (corp)

로그 이벤트가 발생한 고객사의 정보를 담는 객체입니다.

필드명	타입	설명	입력값 예시
`corp.id`	string	회사 ID	`AAAA-BBBB-CCCC-DDDD-EEEE`
`corp.name`	string	고객사명	`EXAMPLE COMPANY`

파일 객체 (file)

파일 업로드, 다운로드 등 파일과 관련한 이벤트가 발생했을 때 기록하는 객체입니다.

필드명	타입	설명	입력값 예시
`file.name`	string	파일 이름	`example.pdf`
`file.ext`	string	파일 확장자	`pdf`, `docx`, `xlsx`
`file.path`	string	파일 경로	`https://dl.google.com/documents/example.pdf`
`file.storageName`	string	파일이 저장된 스토리지 이름	`SharePoint Storage`

정책 객체 (policy)

로그 이벤트와 관련된 조건부 정책 정보를 담는 객체입니다.

필드명	타입	설명	입력값 예시
`policy.id`	string	정책 ID	`policy-xxxxx`
`policy.name`	string	정책 명	`파일 다운로드 정책`
`policy.type`	string	정책 유형	`MENU` : 업무 시스템 제어 정책 `WORK_SYSTEM_APP` / `WORK_SYSTEM_SITE` : 앱 / URL 입력창 정책 `REGEX_SCRIPT` : 입력 민감정보 관리 정책 `PERSONAL_REMOTE_DESKTOP` : 개인 데스크톱 정책 `REMOTE_CONSOLE` : 원격 콘솔 정책
`policy.rule`	string	정책 상세 값을 저장하는 필드 (JSON 문자열 형태)	`{"access":"allow","conditions":{}}`

업무시스템 객체 (workSystem)

로그 이벤트가 발생한 업무 시스템(앱, URL 입력창)의 정보를 담는 객체입니다.

필드명	타입	설명	입력값 예시
`workSystem.id`	string	업무시스템 ID	`pppppppp-qqqq-rrrr-ssss-tttttttttttt`
`workSystem.type`	string	업무시스템 타입	`app` : 앱 , `site` : URL 입력창
`workSystem.name`	string	업무시스템 이름	`그룹웨어 시스템`
`workSystem.desc`	string	업무시스템 설명	`회사 내부 문서 및 일정 관리 시스템`
`workSystem.url`	string	업무시스템 접속주소(이동 후 URL)	`https://groupware.company.co.kr/main`
`workSystem.prevUrl`	string	이동 전 URL	`https://portal.company.co.kr`
`workSystem.isIap`	boolean	업무시스템 IAP 여부	`true`, `false`
`workSystem.domain`	string	접속 주소의 도메인	`groupware.company.co.kr`
`workSystem.category`	string	접속 주소의 카테고리	`business`
`workSystem.isAllow`	boolean	접속 허용 여부	`true`, `false`

민감정보 객체 (sensitive)

민감정보 검사 관련 정보를 담는 객체입니다.

필드명	타입	설명	입력값 예시
`sensitive.isAllow`	boolean	민감정보 검사 허용/차단 여부	`true`, `false`
`sensitive.inputData`	string	사용자 입력 값 (암호화 상태)	`user input data`
`sensitive.regexes`	string	검사 정규 표현식 정보	`\\d{3}-\\d{4}-\\d{4}`

에러 객체 (err)

에러 발생 시 에러 정보를 담는 객체입니다.

필드명	타입	설명	입력값 예시
`err.type`	string	에러의 유형 분류	상세 오류 코드 참조
`err.desc`	string	에러 상세내용 설명	`서버와의 통신 중 문제가 발생하였습니다.`

RBI 객체 (rbi)

RBI(격리브라우저) 관련 정보를 담는 객체입니다.

필드명	타입	설명	입력값 예시
`rbi.url`	string	rb-app (사용자가 접속한 RBI pod) 주소	`https://rbi.example.com/12345`

이벤트 코드 목록

event 필드에 사용되는 이벤트 코드 목록입니다.

관리자 이벤트 (logType : ADMIN)

분류	이벤트 코드	이벤트명	설명
앱 관리	POST_APP_SERVICE_ICON	앱 이미지 등록	앱 이미지 업로드
	DELETE_APP_SERVICE_ICON	앱 이미지 삭제	앱 이미지 삭제
	APP_MANAGEMENT_MENU_READ	앱 목록 메뉴 접속	업무시스템 하위의 앱 메뉴 > '앱목록' 탭 클릭
	APP_POLICY_READ	앱 조건부정책 메뉴 접속	업무시스템 하위의 앱 메뉴 > '조건부정책' 탭 클릭
	APP_DETAILS_READ	앱 상세 조회	업무시스템 하위의 앱 메뉴 > '앱목록'에서 특정 앱 클릭하여 상세 조회
	APP_POLICY_DETAILS_READ	앱 조건부정책 상세 조회	업무시스템 하위의 앱 메뉴 > '조건부정책'에서 특정 조건부정책 클릭하여 상세 조회
URL 정책	URL_MANAGEMENT_MENU_READ	URL입력창 목록 메뉴 접속	업무시스템 하위의 URL입력창 메뉴 > 'URL' 탭 클릭
	URL_POLICY_READ	URL입력창 조건부정책 접속	업무시스템 하위의 URL입력창 메뉴 > '조건부정책' 탭 클릭
	URL_DETAILS_READ	URL 상세 조회	업무시스템 하위의 URL입력창 메뉴 > 'URL'에서 특정 url을 클릭하여 상세 조회
	URL_POLICY_DETAILS_READ	URL입력창의 조건부정책 상세 조회	업무시스템 하위의 URL입력창 메뉴 > '조건부정책'에서 특정 조건부정책 클릭하여 상세 조회
	URL_LIST_DOWNLOAD	URL입력창의 URL 목록 다운로드	등록된 URL 목록을 파일로 다운로드
	WEB_CATEGORY_MENU_READ	URL입력창의 카테고리 메뉴 접속	URL입력창 > '카테고리' 탭 클릭
업무시스템	POST_WORK_ITEM	업무시스템 등록	업무시스템(앱 또는 URL입력창의 URL) 등록
	PATCH_WORK_ITEM	업무시스템 수정	업무시스템(앱 또는 URL입력창의 URL) 수정
	DELETE_WORK_ITEM	업무시스템 삭제	업무시스템(앱 또는 URL입력창의 URL) 삭제
	POST_WORK_ITEM_GROUP	업무시스템 그룹 등록	업무시스템(앱 또는 URL입력창의 URL) 그룹 등록
	PATCH_WORK_ITEM_GROUP	업무시스템 그룹 수정	업무시스템(앱 또는 URL입력창의 URL) 그룹 수정
	DELETE_WORK_ITEM_GROUP	업무시스템 그룹 삭제	업무시스템(앱 또는 URL입력창의 URL) 그룹 삭제
민감정보 정책	SENSITIVE_INFO_MANAGEMENT_MENU_READ	입력 민감정보관리 메뉴 접속	입력민감정보 메뉴 > '정규 표현식' 탭 클릭
	SENSITIVE_INFO_POLICY_READ	입력 민감정보 관리 조건부정책 접속	입력만감정보 메뉴 > '조건부정책' 탭 클릭
	SENSITIVE_INFO_POLICY_DETAILS_READ	입력 민감정보 관리의 조건부정책 상세 조회	입력민감정보 메뉴 > '조건부정책'에서 특정 조건부정책 클릭하여 상세 조회
정규 표현식	POST_REGEX_POLICY	정규 표현식 등록	입력 민감정보에 사용할 정규 표현식 등록
	PATCH_REGEX_POLICY	정규 표현식 수정	기존 정규 표현식 수정
	DELETE_REGEX_POLICY	정규 표현식 삭제	정규 표현식 삭제
업무시스템 제어	WORK_ITEM_MENU_POLICY_READ	업무시스템 제어 메뉴 접속	업무시스템 제어 메뉴 접속
	WORK_ITEM_MENU_POLICY_DETAILS_READ	업무시스템 제어 정책 상세 조회	업무시스템 제어 정책의 상세 설정 정보 조회
조건부 정책	CREATE_CONDITIONAL_POLICY	조건부 정책 등록	조건에 따라 적용되는 정책 규칙 등록
	UPDATE_CONDITIONAL_POLICY	조건부 정책 수정	기존 조건부 정책의 설정 내용 수정
	DELETE_CONDITIONAL_POLICY	조건부 정책 삭제	조건부 정책을 시스템에서 삭제
	CREATE_CONDITION	조건 등록	정책 적용을 위한 조건 규칙 등록
차단 화면 설정	PATCH_BLOCK_PAGE	차단 화면 정보 수정	기존 차단 화면의 내용 및 디자인 수정
	BLOCK_SCREEN_SETTING_MENU_READ	차단 화면 설정 메뉴 접속	차단 화면 설정 메뉴 접속
상단바 설정	POST_EXTERNAL_INTERFACE	상단바 외부 링크 등록	사용자 페이지의 상단바에 등록할 커스텀 버튼에 URL 등록
	PATCH_EXTERNAL_INTERFACE	상단바 외부 링크 수정	기존 상단바 커스텀 버튼의 설정 수정
	DELETE_EXTERNAL_INTERFACE	상단바 외부 링크 삭제	상단바 커스텀 버튼을 인터페이스에서 삭제
	TOOLBAR_CUSTOM_URL_BUTTON_MENU_READ	상단바 설정 메뉴 접속	상단 툴바 커스텀 버튼 설정 메뉴 정보 조회
데스크톱	DISCONNECT_USER_DESKTOP	개인 데스크톱 정보 삭제	관리자가 사용자의 개인 데스크톱 연결을 강제 해제
	PERSONAL_DESKTOP_MENU_READ	등록된 데스크톱 메뉴 접속	데스크톱 하위의 개인데스크톱 메뉴 > '등록된 데스크톱' 탭 클릭
	PERSONAL_DESKTOP_POLICY_READ	데스크톱 조건부정책 메뉴 접속	데스크톱 하위의 개인데스크톱 메뉴 > '조건부정책' 탭 클릭
	PERSONAL_DESKTOP_DETAILS_READ	데스크톱 조건부정책 상세 조회	데스크톱 하위의 개인데스크톱 메뉴 > '조건부정책'에서 특정 조건부정책 클릭하여 상세 조회
WOL 관리	POST_WOL_INFO	데스크톱 WOL 정보 등록성	Wake-on-LAN 기능을 위한 시스템 정보 등록
	PATCH_WOL_INFO	데스크톱 WOL 정보 수정	기존 WOL 시스템의 설정 정보 수정
	DELETE_WOL_INFO	데스크톱 WOL 정보 삭제	WOL 시스템 정보를 목록에서 삭제
	WOL_MANAGEMENT_MENU_READ	데스크톱의 'WOL 관리' 메뉴 접속	데스크톱 메뉴 > WOL 관리 메뉴 접속
	WOL_DETAILS_READ	WOL 상세 조회	특정 WOL 시스템의 상세 설정 정보 조회
원격콘솔	POST_REMOTE_CONSOLE	원격 콘솔 정보 등록	원격 접속을 위한 콘솔 시스템 정보 등록
	PATCH_REMOTE_CONSOLE	원격 콘솔 정보 수정	기존 원격 콘솔 시스템의 설정 정보 수정
	DELETE_REMOTE_CONSOLE	원격 콘솔 정보 삭제	원격 콘솔 시스템 정보를 시스템에서 삭제
	REMOTE_CONSOLE_MENU_READ	원격 콘솔 메뉴 접속	원격콘솔 메뉴 > '서버 목록' 탭 클릭
	REMOTE_CONSOLE_POLICY_READ	원격 콘솔의 조건부정책 메뉴 접속	원격콘솔 메뉴 > '조건부정책' 탭 클릭
	REMOTE_CONSOLE_DETAILS_READ	원격 콘솔 서버 상세 조회	원격콘솔 > 서버 클릭하여 상세 조회
	REMOTE_CONSOLE_POLICY_DETAILS_READ	원격 콘솔 조건부정책 상세 조회	원격콘솔 > '조건부정책'에서 특정 조건부정책 클릭하여 상세 조회
PAC 파일	POST_PAC_FILE_INFO	PAC 파일 정보 등록	PAC 정보 등록
	PATCH_PAC_FILE_INFO	PAC 파일 정보 수정	기존 PAC 파일의 설정 정보 수정
	DELETE_PAC_FILE_INFO	PAC 파일 정보 삭제	PAC 파일 정보를 삭제
	GET_PAC_FILE	PAC 파일 다운로드	등록된 PAC 파일 다운로드
	PAC_FILE_SETTINGS_MENU_READ	PAC 파일 설정 메뉴 접속	PAC 파일 설정 페이지의 메뉴 정보 조회
	PAC_FILE_DETAILS_READ	PAC 파일 상세 조회	특정 PAC 파일의 상세 설정 정보 조회
설정 및 기타	PATCH_COMPANY	설정 메뉴에서 회사정보 수정	설정 메뉴에서 회사정보 수정
	SHIELDGATE_FILE_MANAGER_MENU_READ	SHIELDGate 파일함 관리자 페이지 이동	SHIELDGate 파일함 관리자 페이지 접속
	COMPANY_USAGE_SETTINGS_MENU_READ	설정 > 사용 설정 메뉴 접속	설정 > 사용설정 메뉴 조회
	IAP_SETTINGS_MENU_READ	설정 > IAP 설정 메뉴 접속	설정 > IAP 설정 메뉴 정보 조회
	SECURITY365_MANAGER_MENU_READ	Security365관리센터 페이지로 이동	Security365관리센터 페이지 접속
	ADMIN_HOME_MENU_READ	관리자 홈 메뉴 접속	관리자 홈 페이지 메뉴 정보 조회
로그 메뉴	USER_LOG_MENU_READ	사용자 로그 메뉴 접속	사용자 로그 조회 메뉴 접속
	ADMIN_LOG_MENU_READ	관리자 로그 메뉴 접속	관리자 로그 조회 메뉴 접속

사용자 이벤트 (logType : USER)

분류	이벤트 코드	이벤트명	설명
인증	CALLBACK_SECURITY365_CODE	로그인	SHIELD Gate 사용자 로그인
	POST_SIGN_OUT	로그아웃	SHIELD Gate 사용자 로그아웃
	POST_RELAY_TOKEN	서비스 이동	Security365 관리센터에서 SHIELD Gate 관리자페이지로 이동
격리 브라우저	POST_INQUIRY_WORK_ITEM_ACCESS_URL	브라우저 접속	앱 또는 URL입력창을 통해 격리 브라우저 접속
	RBI_URL_CHANGED	브라우저 접속 후 이동	격리 브라우저 내에서 사용자가 다른 URL로 이동
	RBI_CHECK_INPUT_TEXT	사용자의 웹 입력 데이터 검사	민감정보 정책에 따른 사용자 웹 입력 데이터 검사 및 검증
	RBI_CLIPBOARD_ACCESS_RB2PC	격리 브라우저에서 복사	격리 브라우저의 데이터를 PC로 데이터 복사 (ctrl + c)
	RBI_CLIPBOARD_ACCESS_PC2RB	격리 브라우저로 붙여넣기	PC에서 격리 브라우저로 데이터 붙여넣기 (ctrl + v/x)
	RBI_USAGE_ERROR	격리 브라우저 오류	격리 브라우저 사용 중 발생한 시스템 오류 기록 [오류 코드 상세보기]
	RBI_SESSION_TIMEOUT	세션 타임아웃	브라우저 세션 타임아웃
개인화	POST_FAVORITE_ITEM	즐겨찾기 등록	즐겨찾기 등록
	DELETE_FAVORITE_ITEM	즐겨찾기 삭제	즐겨찾기 정보 삭제
파일	RBI_FILE_DOWNLOAD	파일 다운로드	격리 브라우저를 통한 파일 다운로드
	RBI_FILE_UPLOAD	파일 업로드	격리 브라우저를 통한 파일 업로드
데스크톱	GET_PERSONAL_DESKTOP_USER_REQUEST_URL	데스크톱 신청 페이지 이동	개인 데스크톱 신청 페이지 URL 접속
	GET_PERSONAL_DESKTOP_USER_ACCESS_URL	데스크톱 접속 페이지 이동	개인 데스크톱 접속페이지 이동
	POST_PERSONAL_DESKTOP_INFO_REMOVE_REQUEST	데스크톱 정보 삭제	사용자가 개인 데스크톱 정보 삭제를 요청
	REQUEST_TELEWORK	데스크톱 신청	개인 데스크톱 사용 신청
	CONNECT_TELEWORK	데스크톱 접속	개인 데스크톱 접속
	DISCONNECT_TELEWORK	데스크톱 접속 종료	개인 데스크톱 종료
상단바	GET_EXTERNAL_INTERFACE_ACCESS_URL	상단바 외부 링크 버튼 접속	관리자가 설정한 상단바 커스텀 버튼을 통한 외부 URL 접속
원격콘솔	GET_REMOTE_CONSOLE_TOKEN	원격 콘솔 접속	원격 콘솔 접속을 위한 인증 토큰 발급 요청
	DISCONNECT_REMOTE_CONSOLE	원격 콘솔 접속 종료	원격 콘솔 세션 연결 종료

참고: 실제 사용되는 모든 이벤트 코드는 제품 버전에 따라 추가될 수 있습니다.

상세 오류 코드

격리 브라우저 오류(RBI_USAGE_ERROR) 이벤트에서 발생하는 상세 오류 코드들입니다

번호	오류 코드	설명
1	BLOCKED_BY_POLICY	정책에 의해 차단
2	CONTAINER_DISCONNECTED	컨테이너 연결실패
3	SESSION_TIME_OUT_NO_USED	사용하지 않아 세션 타임아웃
4	NO_TAB_ID_SESSION	비정상 접근
5	ERR_NAME_NOT_RESOLVED	도메인 검색 실패
6	ERR_CONNECTION_TIME_OUT	WEBRTC 연결 초과
7	ERR_CONNECTION_CLOSED	연결 닫힘
8	ERR_CONNECTION_REFUSED	요청 거절
9	ERR_INTERNET_DISCONNECTED	원격 네트워크 연결 실패
10	ERR_EMPTY_RESPONSE	빈 응답
11	ERR_CHROME_BROWSER	원격 크롬 브라우저 에러
12	ERR_TIME_OUT	RB-APP 타임아웃
13	ERR_SSL_PROTOCOL_ERROR	SSL 인증 검증 실패
14	ERR_NETWORK_CHANGED	네트워크 변경 감지
15	POLICY_QUERY_FAILED	실시간 정책 조회 실패
16	FAILED_CREATING_CONTAINER	rb-app 파드 등록 실패 (턴서버 연결 실패)
17	ERROR_GET_CONTAINER_URL	rb-manager를 통해 컨테이너 URL 조회 실패
18	FAILED_NAVIGATED_PAGE	페이지 이동 실패
19	MAXIMUM_PODS_REACHED	파드 최대 개수 초과로 인하여 등록 실패
20	SSL_CERTIFICATE_ERROR	SSL 인증서 오류

참고사항

모든 필드는 선택적(optional)이며, 이벤트 유형에 따라 포함되지 않을 수 있습니다.
빈 객체({})나 null 값은 해당 정보가 해당 이벤트에 적용되지 않음을 의미합니다.
detail 및 policy.rule 필드는 JSON 문자열 형태로 저장되며, 필요 시 파싱하여 사용할 수 있습니다.

개요​

로그 샘플​

공통 필드​

사용자 객체 (user)​

고객사 객체 (corp)​

파일 객체 (file)​

정책 객체 (policy)​

업무시스템 객체 (workSystem)​

민감정보 객체 (sensitive)​

에러 객체 (err)​

RBI 객체 (rbi)​

이벤트 코드 목록​

관리자 이벤트 (logType : ADMIN)​

사용자 이벤트 (logType : USER)​

상세 오류 코드​

참고사항​

개요